• Search user created libraries to satisfy unresolved 
global symbols 

• Dynamically assign memory 

• Create a memory map describing the location of each 
object module and data block loaded 



PROGRAM SEGMENTATION 



The Linking Loader and Macro Assembler permit the user to 

segment source programs into five different sections. These 

sections and their corresponding functions are as follows: 

ASCT - Absolute Section (non-relocatable) 

There may be a limited number of absolute 
sections 1n a user's program. These sections 
are used to allocate/load/inlt'alize memory 
locations assigned by the programmer rather 
than the loader, for example! addresses 
assigned to ACIA's and PIA's. 

BSCT - Base Section 

There is only one Base Section. The linking 
loader allocates portions of th^s section to 
each module that needs space in 3SCT. BSCT 
1s generally used for variables that will be 
referenced via direct addressing. BSCT is 
limited to locations 0-255 of the addressing 
range. 

CSCT - Blank Common (uninitialized) 

There 1s only one CSCT. This section 1s used 
for blank common (similar to FORTRAN blank 
common). This section cannot be Initialized. 
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• DSCT - Data Section 

There 1s only one Data Section. The linking 
loader allocates portions of this section to 
each module that needs a part of DSCT. DSCT 
1s generally used for variables (RAM) which 
are to be accessed via extended mode addressing. 

• PSCT - Program Section 

PSCT is similar to DSCT except that it 1s 
intended to be used for instructions. The 
PSCT/DSCT division was made to facilitate a 
RAM/ ROM dichotomy. 

This section concept is preserved by the Loader during the 
load process. As a module is being loaded, each of its sections 
is combined with the corresponding sections of previously 
loaded modules. As a result, the absolute load module produced 
by the Loader will contain one continuous memory area for 
each section type encountered during the load operation. 

In addition to the program segmentation provided by the 
section concept, the M6800 relocation and linking scheme supports 
named common. The named common concept provides the function 
of initial izabl e common areas within BSCT, DSCT » and PSCT. In 
processing named common definitions, the Loader shall: 

• Assign to each named common area a size equal to the 
largest size defined for the named common during the 
load process. 

• Allocate memory at the end of each section for the 
named common blocks defined within that section. 
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The load maps shown 1n Figure 1-1 describe the load process 
with regard to sections and named common. The module PGM1 
requires memory to be reserved in BSCT, CSCT, DSCT, and PSCT, 
although the only space necessary in DSCT is for the named common 
NC0M1. The module PGM2 requires that memory be allocated in BSCT, 
CSCT, DSCT, and PSCT. Neither module defines any ASCT blocks. 

The load module's map illustrates a typical memory map that 
might be produced by loading PGM1 and PGM2. The BSCT for both 
PGM1 and PGM2 are allocated memory within the first 256 bytes of 
memory. As shown, the first 32 (20 hex) bytes of BSCT are 
reserved by the Loader for use by the disc operating system 
unless otherwise directed. After BSCT, space for blank common 
is allocated, followed by space for PGM2's DSCT. Since PGM1 
requires no DSCT for its exclusive use, none will be allocated. 
The named common block NC0M1 within DSCT is assigned memory at 
the end of DSCT. Finally, the PSCT's for PGM1 and PGM2 are 
allocated along with PSCT's common blocks NC0H2 and NC0M3. 

The Loader assigns memory within sections in the order in 
which the modules are specified. Named common blocks are 
allocated memory at the end of their corresponding section, in 
tha order 1n which thty are defined. Figure 1-2 illustrates a 
load module map produced by loading P6M2, followed by PGM1. This 
load module map 1$ slightly different from the map In Figure 1-1 
Mfwre P6M1 was loaded first. 
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PGMl 



LENGTH 
3 

35 
20 

50 

5 

10 



BSCT 



CSCT 



NCOMl(DSCT) 



PSCT 



NC0M2(PSCT) 



NC0M3(PSCT) 



LENGTH 
10 

35 

20 
10 

60 

10 
5 



PGM2 



BSCT 



CSCT 



DSCT 



NCOMl(DSCT) 



PSCT 



NC0M3(PSCT) 
NC0H2(PSCT) 



ADDRESS 
0 

32 
35 
45 

80 
ICO 
120 

170 

230 
235 
245 



LOAD MODULE 



SYSTEM AREA 



BSCT PGMl 



BSCT PGM2 



CSCT 



DSCT PGM2 



NC0M1 



PSCT PGMl 



PSCT PGM2 



NC0M2 



NC0M3 



FIGURE 1-1 
LOAD MAPS 
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ADDRESS 
0 



LOAD MODULE 



SYSTEM AREA 



BSCT PGM2 



BSCT PGM1 



CSCT 



DSCT PGM2 



NCOM1 



PSCT PGM2 



PSCT PGM 



NCOM3 



NCOM2 



FIGURE 1-2 
LOAD MAP 
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RELOCATION 



Relocation allows the user to assemble a source program 
without assigning absolute addresses at assembly time. Instead, 
absolute memory assignment is performed at load time. In order 
to relocate a program (within memory), the source program must 
be assembled with the M6800 Macro Assembler using the OPT REL 
directive. Programs assembled with this directive will cause 
the assembler to produce a relocatable object module instead 
of an absolute object module. These relocatable object modules 
contain information describing the size of each section (ASCT, 
BSCT, CSCT, and DSCT) and named common area as well as the 
relocation data. A complete description of the. relocatable 
object module format is contained in the M6800 Macro Assembler 
Manual . 

In order to load a relocatable object module, the M6800 
Linking Loader must be used. The Loader assigns load addresses 
and produces an absolute object module compatible with the 
EXORdser loader. 

The advantages of using relocation are: 

* Reassembly is not required for each new absolute load 
address. 

* Relocation via the M6800 Linking Loader 1s faster than 
reassembly. 

* Dynamic memory assignment of modules 1s possible. 
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LINKING 



Linking allows Instructions 1n one program to refer to 
Instructions or data which reside within other programs. If 
all programs are assigned absolute addresses during assembly 
time, it is possible to directly reference another program via 
absolute addresses. However, when using relocatable programs, 
absolute load addresses are not generally known until load time. 
In order to access other relocatable programs or data blocks, 
external reference symbols must be used. These external symbols 
are commonly called global symbols since they may be referenced 
by any module at load time. Although global symbols are used 
to link modules at load time, they must be explicitly defined 
and referenced at assembly time. This is accomplished by the 
H6800 Macro Assembler directives, XOEF and XREF. The XDEF 
directive indicates which symbols defined within a module can 
be referenced by other modules. The XREF directive indicates 
that the symbol being referenced is defined outside the module. 

At load time, global references are matched with their 
corresponding global definitions. Any reference within a module 
to a global symbol is updated with the load address of the 
global symbol. If the loader detects a global reference without 
an associated global definition, an undefined global error will 
be printed and a load address of zero will be assigned to the 
reference. 
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MODULE LIBRARIES 

The M6800 Linking Loader can automatically search a file 
for modules which contain definitions satisfying any unresolved 
global symbols. Such a file is called a library file and is 
composed of one or more object modules. The Loader sequentially 
searches the library file. If a module is found which contains 
a symbol definition satisfying an unresolved global symbol, the 
module will be loaded. Only those modules which can satisfy an 
unresolved reference will be loaded. Since a library file 1s 
searched only once, modules which reference other r>odules within 
the library file should occur within the library file before 
the referenced module. Otherwise, the user must direct the 
Loader to search the library again. 

MEMORY ASSIGNMENT 

During the load process, absolute addresses are assigned 
to the program sections within the specified modules. Normally 
the loader will automatically perform this assignment by allocating 
memory by sections in the order: ASCT, BSCT, CSCT, DSCT and PSCT. 
However, the user may define the starting and/or ending address 
of any non-ASCT section. In this case, the Loader will first 
reserve memory for those sections with defined load addresses 
before allocating space for any other section. The Loader also 
permits a user to specify the relative section offset of a module 
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within a section. However, a section of a module 1s always loaded 
In the associated load section 1n the order In which the module 
was specified, 

LOAD MAPS 

The Loader will optionally produce a load map describing 
the memory layout resulting from the load of the specified modules. 
Figure 1-3 is an example of some of the features included in a 
typical load map. In addition to this full load map* the Loader 
may be directed to produce partial load maps listing only the 
undefined global symbols or section load addresses. 

OPERATING ENVIRONMENT 

Equipment Requirements 

Minimum equipment requirements for the M6800 Linking 

Loader include: 

• EXORdser 

• 10K bytes of RAM 

• Floppy Disc 

• Console 

Software Requirements 

The M6800 Linking Loader operates under the E00S2.3 
floppy disc operating system to load relocatable object 
nodules produced by the M6800 Macro Assembler. 
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i 
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; section n 

USING THE M6800 LINKING LOADER 

CALLING THE LINKING LOADER 

The M68G0 Linking Loader must be called while under the 
control of the disc operating system. When the user types the 
command 

RLOAD < c/r > 

the disc executive will load the Linking Loader. Upon entry, 
the loader prints 

M6800 LINKING LOADER REV rum 

(where n.m is the revision number) 
The character '?' is the Loader's prompt and is printed whenever 
the Loader has completed the last command and is ready for another. 

LOADER INPUT 

The input to the Loader is in one of two forms - commands 
and object modules. The Loader commands control the relocation 
and Unking of desired object modules. The object nodules are 
produced by the M6800 Macro Assembler when the relocation option 
1$ specified. Each source program assembled by the Macro 
Assembler creates a single relocatable object module on a disc 
file. These disc files or those files created by merging one 
or more of these files are used as the input to the Loader. 
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The Loader command structure provides for the loading of an 
entire file or selected modules within a file. In addition, a 
disc file may be used as a library file. 

COMMAND FORMAT 

Each Loader command line consists of a sequence of commands 
and comments followed by a carriage return. The first blank in 
a command line terminates the command portion of the line and 
the remainder is assumed to be comments. Multiple commands may 
appear on a line by using a semi -colon (;) as a command separator. 
The format of a command line may thus be defined as: 



The commands in a command line are executed only after the Loader 
detects a carriage return. 

If a command line is entered incorrectly* the line may be 
corrected in either of two manners, first, the command line 
may be deleted completely by typing CTRL X (the CTRL and X keys 
typed simultaneously). This causes the Loader to ignore the 
current command line and a new prompt (?) will be printed. 
Instead of deleting the entire command line, the command line 
may be corrected by deleting the character(s) in error. This 
1s accomplished by typing a RUBOUT to delete the last character 
typed. The typing of a RUBOUT also causes the last character 
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to be printed. After deleting the character(s) in error, the 
corrected version of the command line may be entered. 

The Loader will execute all the conroands In a conmand Hne 
before another prompt 1s Issued. If an error *s detected while 
attempting to process a conmand, that command will be terminated. 
The remaining commands in the command line will be ignored. 

When using multiple commands per line, it should be noted 
that selected commands require that they are the last command 
on a line. These commands include: 

• INIT 

• All intermediate file commands (if, 1F0N, IFOF) 

• ABSP when used in conjunction with 3n intermediate file 

LOADER COMMANDS 

The Loader commands are divided Into three classes: (1) 
control commands; [2} load directives; (3) state directives. 
The control commands are used to initiate Pass I and II of the 
Loader as well as to return to EXBUG or the disc operating 
system. The load directives are used to identify the modules 
to be loaded. Finally, the state directives direct the assign- 
ment of memory to the various program sections and the production 
of a load map. 
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Command Nomenclature 



<fjiame> - Used to indicate the name of a disc Input 

file. Disc file names must start with an 
alphabetic character and contain a maximum 
of five alphanumeric characters. The disc 
unit upon which the file resides may be 
defined by placing a colon (:) after the 
file name, followed by a valid disc drive 
number. If a disc unit is not specified, 
drive zero will be assumed. 



<m__name> - Used to indicate a named module. Named 

modules are composed of a maximum of six 
alphanumeric characters, the first of which 
must be alphabetic. 



<name> - Used to indicate a named file or module as 

determined by the Loader's current file/ 
module state. 



<number> - Used to indicate a decimal or hexadecimal 

number. Unless preceded by a character 
which is used to denote hexadecimal, the 
number will be interpreted as decimal. The 
allowable number range unless explicitly 
stated otherwise will be: 

0 - 65,535 (decimal) 
0 - $FFFF (hexadecimal) 




- Used to Indicate that the enclosed directive(s) 
is optional. 




Used to indicate that the enclosed directive 
may be repeated any number of times. 



Indicates that one of the enclosed options 
must be used. 
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Control Commands 



ABSP - Produce Absolute Load Module 

FORMAT: ABSP T = < m name> L< pr1ntabl e ->]] 

L - L ^ Information' J J 

DESCRIPTION: ABSP initiates the second pass of the 

Loader. During this pass, an absolute 
binary memory Image is produced in 
EXORciser loadable format on the disc 
file defined by the BO command. If an 
output module name is specified, 1t will 
be included in the module's SO record. 
Any printable information is also included 
in the SO record if specified. The print- 
able information may contain any character 
and is terminated only by a semi-colon or 
carriage return. NOTE: A space 1s a 
valid character 1n the printable Informa- 
tion and does not terminate the command 
line. The module name and printable 
information may not exceed 30 characters. 

If an Intermediate file (IF) was 
generated during Pass I, the second pass 
of the Loader will proceed automatically 
as directed by the conmands entered during 
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the first pass. When an IF 1s being used, 
the ABSP command must be the last command 
in a command line. 

In the event that an IF 1s not 
created during Pass I, the same sequence 
of commands used in Psss I (with the 
exception of the MAP conmands) must be 
repeated exactly as in Pass I. 

Prior to the ABSP command, a binary 
output file must be defined via the BO 
command. 

EXAMPLE: ABSP^ROOT, A SQUARE ROOT PROGRAM 

As a result of this command, the second 
pass of the assembler is Initiated to 
produce an absolute module. The phrase 
'ROOT, A SQUARE ROOT PROGRAM' 1s written 
in the SO record of Lhe absolute module. 
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BO - Binary Output 

FORMAT: BO ■ < f name> 



DESCRIPTION: The BO command 1s used to direct the 

binary output In EXORciser load format 
to a disc file. The disc file defined 
by the BO command must not currently 
exist on the defined drive. 

EXAMPLE: BO=BOBJ Write binary load module on 

file BOB J on drive 0 

BO«BOBJl:l Write binary load module on 

file BOBJI on drive 1 
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EXBUG 



FORMAT: EXBUG 

DESCRIPTION: The EXBUG conroand is one of two commands 

which may be used 'to exit the Loader. 
EXBUG causes control to be returned to 
the EXORciser's EXBUG rr>ode after all 
Loader files are closed. 



2-8 



EXIT 

FORMAT: EXIT 

DESCRIPTION: The EXIT command is one of two corrmands 

which terminates the Loader's activity. 
EXIT causes control to be returned to the 
disc operating system. 
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IDOF - Suppress Printing of Module ID 
FORMAT: IDOF 

DESCRIPTION: The IDOF command suppresses the printing 

of the module name and print information 
associated with each object nodule loaded. 
The Loader is initialized to the IDOF state 



1D0N - Print Module ID 
FORMAT: IDON 

DESCRIPTION: This command causes the printing on the 

console of the name and printable informa- 
tion associated with each object module loaded 
or encountered in a library file. 
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Intermediate File 



FORMAT: IF * < fjiame > 

DESCRIPTION: The IF corrmand defines a file to be used 

as an intermediate file. An intermediate 
file is a copy of all Pass I Loader 
conmands and object modules. It is used 
to direct the Loader durirg Pass II, 
instead of requiring the user to retype 
the Pass I corrmand sequence during Pass 
II. The IF corrmand also automatically 
places the Loader in intermediate file 
mode similar to the IFON command. Like 
the IFON command, the IF command must be 
the last command in a command line. 

The IF file name must be a valid 
disc file name and may not be the name 
of an existing file on the specified disc 
unit. 

EXAMPLE: IF-IFILE Defines IFILE on drive 0 as the 

intermediate file> 
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IFOF - Intermediate 
FORMAT: IFOF 



File Mode Off 



DESCRIPTION: IFOF temporarily suppresses the creatio 

of the intermediate file until an IFON 
directive is encountered. This command 
must be the last command in a command 
1 ine. 



IFON - Intermediate File Mode On 
FORMAT: IFON 

DESCRIPTION: This command directs the Loader to write 

all further commands and object modules 
onto the intermediate file. This directive 
remains in effect until an IFOF or Pass 
II command is detected. The IFON command 
must be the last command on a command 
Une. IFON 1s implied when the Inter- 
mediate file 1s defined by the IF command. 
If an Intermediate file is to be used 
during Pass II, the IFON directive must 
*>e 1n effect. 
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INIT - Initialize Loader 



FORMAT: INIT 

DESCRIPTION: INIT initializes the Loader for Pass I. 

This command is performed automatically 
when the Loader is first initiated. The 
use of this command permits several 
output object modules to be created by 
the Loader. The INIT command must be 
the last command in a command line. 
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Object Input 

FORMAT: 01 = < f_name> 

DESCRIPTION: The 01 command is used to identify an 

input file containing one or more object 
modules. The file nam* inust be the name 
of an existing disc file. 

EXAMPLE: 0I=PGM1 Object inp^t on file PGM1 on 

drive 0 

0I-PGM2: 0 Object input on file PGM2 on 

drive 0 



Load Directives 



FILE - File Mode 



FORMAT: FILE 



DESCRIPTION : The FILE directive is used to place the 

Loader in file mode. While in file mode, 
the Loader will operate on aU the modules 
within a file as directed by the load 
directives. The file mode 1s the default 
mode. The file mode may be temporarily 
overridden by the ' :M* option of the LOAD 
command. 
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- Library Search 



DESCRIPTION: The LIB conmand instructs the Loader to 



search the specified object modules for 
those modules which satisfy any undefined 
global references. Any module that 
satisfies a global synbol will bp loaded. 

The object modules to be searched 
are specified in the same manner as 
explained in the description of the LOAD 
command . 

Modules loaded via the 1.18 conrnmd 
may also reference global symbols that 
are not defined. Since a library file fs 
searched once for each LiB '.ommand, care 
should be taken when creating a library 
file 1* order to avoid multiple passes of 
the same library file. 



E *A*IE: LIB 




LIB-ftIB:l 
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LOAD - Load a File or Module 



FORMAT : LOAD 



[=< number >1 f 1 f r< n , Mer>1 r 



DESCRIPTION: The LOAD conmand directs the W^OG LinMnr 

Loader to load the specific object fiUs 
and/or modules. 

If a < number > is g-ven, the Loader 
win load the next < number > of modules 
from the disc file defined [>y the 01 
c omnia nd. When the < number > format 
the LOAD command is used, the ':H l feature 
or the MODU directive must be in effect. 
The 1 :M' option causes the Loaaer to enter 
module mode only for the indicated sub- 
command. A maximum of 255 modules may be 
loaded at one time with this form. 

The use of the <name> form of the 
LOAD command causes the Loader to load 
the defined module or file. The<name> 
must be a valid file or module name. To 
load a module by name, the ' :M' feature 
or the MODU directive must be in effect 
and the module must be contained within 
the disc file defined by the 01 a***- 
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*re not rewo UnJ mor to , ^ 
search. 

When no options a , e specified as part 
of the LOAD command, only one file or 
module will be loaded frwn the disc file 
defined by the 01 comriand. 



EXAMPLE: L0AD*PGM1:1 Loads all modules within 

file PGM1 on disc drive 1 



L0AD=1:M,PGM2:M Loads from the input file 

the next nodule and the 
module named PGM2 



L0AD*P(*I3 Loads the file PGH3 from 

drive 0 or the module PGM3 
from tr.e defined input file. 
The file/module mode of the 
Loader determines whether 
a file or module will be 
loaded. 



MODU - Module Mode 



FORMAT : MODU 

DESCRIPTION ; The MODU directive places the Loader i„ 
the module node. While 1r> the module 
mode, the < name > anci <number> options 
of the load directives shall refer to 
nodules. 
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SKIP - Skip Input Modules 

FORMAT: SKIP- < number > [ :M J 

Ski(> the nunber of ,^ dules ,„ 

file indicated by the 'H ccmand. 
The MODU directive or ':M' opt<on wst 
be in effect. A maximun cf ?S5 modules 
ray be skipped with a single conrcand. 

EXAMPLE : SKIP=2:M skips the next two modules on 

the input file 



SRCH - Search for a File or Module 
FORMAT: SRCH=< name > [ : m] 

DESCRIPTION: SRCH causes the Loader to search for a 

named object module or file. If the 
MODU directive Is in effect or the 
option specified, the current disc file 
defined by the 01 command will be searched 
for the named module. If the Loader is 
operating in the file mode as directed by 
the FILE command, a disc search will be 
performed for the named f-ile. If the 
named file is found, this file will 
become the new object input file for 
future Loader coirmands. When in file 
mode, the file named must be a valid 
filename and the drive unit may be given 
by typing a colon (:) and the drive 
number after the file nam,. If no drive 
unit is specified, drive 0 1s assumed. 

EXAMPLE: SRCH-FAOD: 1 Searc |^ D d1 V'ou nd/Sw^l' 

^the new input file. 



nodule nailed 
SftCH«SINE:M Searches for the ^ file . 
SINE on the currc 
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Oik - f /iTf<-.rS. \.r,zi)tUjt, tsjmtzr 



',et tne current reUM /e address of the 
specified option '^CT. ISC', S' PSCT; 
to the given number. The defined number 
rust bf; greater than or equal to the 
section' % current Is sit ion counter address. 
The \ ' option cajces the Loader to start 
the specified section of all future modules 
loaded on an address modulo the given 
number. The 'V option remains In effect 
until revoked with a '\ 0 J option or until 
the current pass of the Loader 1s complete. 
If the '\ ' option 1s in effect when 
m«*>ry 1s assigned, the start address 
of the section will be nodulo the given 
nunter. The 'V option doas not apply 

„ Ki/wf* within the sp«c1f1ed 
to named common blocks wnnin 

section. 
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EXAMPLE: CURP=$100 
CURP = \$100 



Sets the relative PSCT location 
counter to 100 (hexadecimal). 



Causes the Loader to update 
PSCT's relative location counter 
to the next modulo 100 (hexa- 
decimal) address. This function 
is performed for each module 
loaded after this command. 
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- Loader Symbol Definition 



FORMAT: DEF:<namel> = 







ASCI ' 


J< number > 




BSCT 


|< name2 > 




' DSCT 






PSCT 



DESCRIPTION: The DEF command is used to define a 

global symbol and enter it in the global 
symbol table. The symbol to be defined 
is given by namel and must be a valid 
Macro Assembler variable name. The 
symbol may not currently be cefined. 
If the < number > option is used, the 
symbol will be defined with the given 
number as the relative address within the 
specified section. The DET command may 
be used to provide another name for a 
previously defined symbol by using the 
<na«ne2> option. <nan:e?> must be a 
currently defined global symbol. The 

,crT PSCT OSCT, PSCT - 
section options - ASCT, 

with the define, section ASCT is the 
default section. 

(hexadecimal). 



EXAMPLE: DEF:ACIA1-$EC10,ASCT 
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- Ending Address 



B 

FORMAT : END I C 

D 



= < nunter > 



DESCRIPTION: The END commands are used tc set the 



absolute ending address of the associated 
section (8SCT. CSCT, DSCT or P3CT). If 
both an ending and starting address are 
defined, the size described by these 
boundaries must be greater than or equal 
to the size of the associated section. 



EXAMPLE: ENDB=255 



8SCT will be allocated such that 
the last address reserved is 255 
(decimal ). 
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Prints Load Maps 
FORMAT : MAP 




DESCRIPTION: The MAP commands are useii to display the 
current state of th«* nodules loaded or 
the Loader's state directives. 

MAPC - Prints the current size, user 
defined starting address, and 
user defined ending address for 
each of the sections, as well 
as the size, starting addres,. 
and ending address for each ASCT 
defined. 

MAPF - A full map of the state of the 
loaded modulo* Is produced a. ter 

WS ■ The Loader t »X^ t tlT e 
sections not endlna 
supplied sterling »Jd/o 
address. A wmoiy . , d dress 
de ,1nes the 5 J r r e«h sectfor. 

and ending address ror = 

1s printed. 

„ . .< » list of a" 9 ,ob "! r * f * f ' 
WU ' [nil ^'currently 
undefined. 
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- Starling Address 



row 



VI R I C 

[) 

p 




< number > 



DESCRIPTION: fhf SIR commarKK set the absolute start- 
ing address of t. ! -.e associated section 
(BSCT, CSCT, DSCT, PSQ ) < Those sections 
whose starting address is "f>t rff-fin*d by 
the user will be assigned a starting 
address by the Loader. 



tiXAMPLL : STRP--$1000 



STRB--0 



PSCT will be allocated memory 
starting at 1000 ' hexadecimal , . 

Overwrites the default starting 
address of BSCT. 
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APPENDIX A 



A SUMMARY OF M6800 LINKING LOADER COMMANDS 



CO WAND 



FUNCTION 



CONTROL COMMANDS 



ABSp[=<m_nanie>[,< printable Informations)] InitTates Pass ir 

Specify the binary object file 
Give control to EXBUG 
Give control to the disc operating system 
Suppress identification printing 
Print module identification information 
Specify the intermediate file 
Intermediate file mode off 
Intermediate file mode on 
Ini tial ize the Loader 



BO- < f_name > 

EXBUG 

EXIT 

IDOF 

1DON 

IF=*< f_narne> 
IFOF 

j FON 



r, •. = < 



Specify the object input file 



load direct:;;.: 



FILE 
LIB 



Enter file mode 



MODU 

SKIP* < number > [:«] 
$RCH«<name> [:M] 



Library search 
end load 

Load the Indicated 
r*ile($)/module(s) 



Enter module mode 
Skip files/modules 
Search for a file or module 



COMHANIJ 



SI ATI COMMAUDS 



CUR { \)) • [\ ] < nu mhor > '->t <wrront 1 *>*".o t lor* ujurit^r 



IH f : < rititnol > - ■ 



< nunilif*r> 

< t Minus' > 



I.NIJ 



( C I < number > 
0 



MAPC 



* ftSCT 
[ J S(.T 



( .j*t '^-i.tion ending ^mlrey 



I m uir-r assigned sec 1 1 o-"" i1/cs and 
addro r . # ,e$ 



MAW 



list full lo.jd I'iap 

I v,t loader a'> r .1<iM--d r .i-<:tlOn dies and 
odd re. ' jCs 



1 < 



< I ; I 



I 1 *i t u ruler f 1 ihmJ *.yn>i ■ 1 



M'f:Moi'i ■< tii»"t 1 rvj oddro'.s 
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APPENDIX V, 



UNKING I.OAOFR WROR Mt V*AM 



Errors detected by the Linking Loader while processing a command 
or loading a nodule will result in an error ness^ie being printed at 
the user's terminal. These errors are divider] into two class if icatiens: 
fatal errors and non-fatal (warning) errors. When the Loader detects 
a non-recoverable error, a fatal error message will be nr-V-t^. Any 
commands not processed on the last command lire will be ignored and 
a new prorr.pt printed, if the Loader can recover *rom an error, only 
a warning message will be printed. 



FATAL ERROR MESSAGES 



Message Expl anation 



3Ai ESCT Assignment Error - the comb -red size of 8SCT 

is greater than the amount that i;an be allocated ir 
the defined BSCT area. 



COV Common Overflow - the size of a section's common is 

greater than 65,536. 



GAE General Assignment Error - the Loader cannot assign 

absolute memory addresses. This nay result from: 

• the definitions of ASCTs 

• user assignment of section addresses 

• the combined length of all sections exceeding 
65,536 

• the order 1n which the Loader assigns memory 
1CH Illegal Command 
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IOR 



Illegal Object Record - the Input module Is not a 
valid relocatable object module. 



ISY 



Illegal Syntax - error in the option or specification 
field of a command. This error may also occur when 
a command is not terminated by a semi -color, space or 
carriage return. 



LOV 



Local Symbol Table Overflow - not enough memory for 
all the global (external) symbols defined by the 
object modules. 



sov 



Section Overflow - the size of a section is greater 
than 65,535. 



UAE 



HBO 



User Assignment Error - the user has incorrectly 
defined load addresses. This error occurs when; 

• the user defined end address is less than the 
user defined start address 

" l h A sp * c V ] located b * the user defined start 
S? S2 ffir H that reoXV 

• the user has defined load addresses which overlap. 

Undefined BO File 



WARNING jjtSSAGE 3 



Message 
MDS-< symbol > 



Explanation 

^ ~K «SS?L,-, ,h, ,t M *- !»» »««»■ 
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,nc <r<vinbol> Undefined Symbol - the < symbol > was not 
UDS -< symbol dur .^ pass j A load a<j(iress of 

zero wi 1 1 be assumed. 



FATAL I/O ERRORS 

If the Loader detects an error while attempting to read or 
write from disc» the following message will be printed. 

OK xx ST yy f_name 
where xx is the disc unit, yy is the I/O error, anrj f_name is 
the name of the file being referenced. If an I/O error is 
detected while creating an intermediate file, the Loader shall 
suspend the IF creation. In this event, the user should 
reinitialize the Loaner. 

1/0 Errors Explanation 

5 0nly one out ^ 1 f 'le my be opened at any time 
^ Device not ready 

Invalid device (Loader error) 

6 Duplicate file name 
1 Named file does not exist 

8 file not opened 

9 Unexpected end-of-fll e 
Directory or disc space full 
Checksum error on object record 



5 
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APPENDIX C 



EXAMPLES OF LOAD OPERATION 

This appendix serves to Illustrate the major Matures provided 
by the M6800 Linking Loader. Figures C-1, C-2 and C-3 show three 
programs which have been assembled by the M6800 Macro Assembler. 
The relocatable object modules created by assembling these programs 
are used as input modules to the Loader in Figures C-4, C-5 and C-6. 
Figure C-4 illustrates the use of the Loader without an intermediate 
file. In Figure C-5, an intermediate file is created and an example 
of user defined starting addresses is shown. An illustration of 
library files is provided in Figure C-6. The library file PG120 was 
created by merging files PG 10 and PG20. 
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Pttt 001 ^. r*X*A« TO c*iN7 OtT MENACES (WIN) 



000)1 ?w fv.i 

' x>/ - Cf T Ra. Cfiff , NOG, UEN-100 

00 ° ,?? TTl - TOGttH TO PRINT 0U1 fltSSACFS tmrn 

IW MESSAGE PROGRAK 1 
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,»>.,>. : cr 1? p7ft rotfc^ i ,INP$CT) 

•XOSIN -v. ^yj rd . K c 0: P7R 70 *$$AGE : UN KG!) 
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0001 * W! A 1*4- 'Li ft:04 PTR r0 4 fIF£F w j^, 

000l c 
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ox'j'!*! »>. ••.•■! - <*£ : comx message cunt 

>»:<::>; -v..; c« f : ,, CCWW MESSAGE 

'''>'■' KjW. COTW* SECTIOft 

.>X»24.; A.. . h:.;,;;t ,,,, ^ &>y£$ 

'»■'- •■ >:--:t data sec tic* 

W'-i i L ^ * FCE 4 tELSNEATE END Of MESSAGE 

' ^ : :. T FftX-ftW SEC Tien 

*•-■ m i-j! F'V MESSAGE !•• 

• - ' ;4 « " It 4 

'iVi 2 J • 

• £UE**«. fiffERENCES 

x:y • 

»•;" '=:?.' hTEST 

GOO £ « KEf Ex T HS03. £<C T . MSG4, ANY STACKj EX8EXT, PGK2 

yx'4v ♦ 

■>»4, • EiitWc KfENITIOfc 

0004 L * 

iBt* M562.KSC1.EXBWT, START. PfilNE 

\V4* r024 A iiim £•>; 4FC24 El&JG WZNT RlVTlNE 

FIGURE C-l 

MESSAGE PROGRAM 1 
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FIGURE C-l 
MESSAGE PROGRAM 1 (continued) 
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PrtuE 'X-5 ^1 fmcj» io mm out he>s*:{-3 iminj 



R ATEST 00057*000$* 
N? BCGffl 00OO9* 
Hi BCCfPlj OW!** 
NB COO! Crttt 00021*O>071 
N& 0000 O!0CT 00020*00073 
P Etl-ENT iaX'?8+ 

D EJEPFJ 0004 i 00045*00055 r^) tl ,xhvv ^5 

P 004C FR>:«P7 00072 00075 0':»07& 000*] i 

P 0024 lOOPI 0<>>75*0OO34 
DP 0000 MSG! 0O010 0003!* 0004 3 
NB 0000 PIJOIF 'XH)i 0*00054 
DD 000") NSC 2 0001 1 00027*0004 r 
K£ 0Oj2 K£.02r 00011* 
ftB tt03 OX' 12 0003*00040 
KB C004 t?03P OOO! 2*0001 2 
FD «S04 'XOl? -XK>3d»0OO4-4 
N£ COO: HSOAf 

C 0000 ffaXST '["V'^OvOt* 
DP CO!? F1}!NE 00043 000*0* 
R Fl>2 0003*00056 
R ■iift.' 1 ' O;«O38*O0O52 
LP ox* ST^r 00043 00053* 

P 0O4£ TOFVTR 00070 000^ 00062 00092* 



FIGURE C-l 
MESSAGE PROGRAM 1 (continued) 
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PME 001 PG2 

00001 
00002 
00003 
00004 
00005 
00006 

00007N 0000 
00009N 0000 
00009K 0002 
00010N 0004 
00011N 0006 



OPT 

TTL 



m 

mm TO PRIHT OUT <ES*WES (SUWW**, 
• KSSAGE POINTER AREA (BOOPfti 
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Boorti 


cm 
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0002 


A KSG1PT 
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A HSG2PT 
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RMB 
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A CKSG 
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/COWON TEST PROGRAM 
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0015 
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00020 




♦ PASSAGES 3 
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♦ 
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00045 
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00047 
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w ■ 9 »W 



# START OF PROGRAM 2 
* 

PSCT 

MP0H2 LDX K9G1PT ffilKT *SSAC£ I 
A JSft EOWT 

# 

♦ PRIKT PtSSAGE 2 

/ LM ftttt PR!***** 2 

FIGURE C-2 
MESSAGE PWSftAM 2 
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002 P02 PROGRAH TO PRINT OUT fCSSAGES fSUBPRGGftftj 

DATA SECTJCW 



000600 OOOA Key 

00051DOOOA 0014 A fW 20 

W052D001E 0001 A STACK RMB 1 STACK STORAGE 

00054 



F364 A EXfiEKT ECU IfSM 



00056 
TOTAL 



END 
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DO 001E STACX 00047 00052* 
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MESSAGE PROGRAM 2 (continued) 
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M*8U0 lIHMW* LOADE* PEV 

'L0AD=PG10«PG£a 

<0I=PG30;L0AD 

" bo=bcvtit 
•rb:p 

•LDRD=PG10.PG£a 

"ai*PS3a;LD*ti 

?MAPF 

NO UMDEFINE.li SYMBOL^ 
MRP 

VTP END COMN 
1 000 
1 006- 

ooao 

0 0 SO 
00?fc 
00E*> 



1.0 



H 

R 

B 

D 
P 



0006* 
0 0 06- 
0')£? 

0 0 ^ : 0 
0 Oc'f 1 
00*? 



end 
1 oos 
1 Out 

004* 

i"j07F 

0 OC ; : 

MODULE NmME VI K T I 



L» 0 1 D 

0 0 ':• 0 

II H M II 

0 0 0 

" c t pu: 



PGl 

PG£ 

pg :-• 
common 

MR me : 

ECQMM L 

BCDMM? fc 
DEFINED 

MRME ' 

MTEiT H 

Ml'?< I- 

:tapt * 

■e:-'IT 



; i;e 

0 i.i 08 

0 0 1 c .> 
YMtDL 

I-TP 

1 006. 

HOC 0 

fiiif-' i '» 



n O^ 

I J 0 >! IT' 

MRMR 
EHFENT 

rr: 134 



0'»c'0 uOr'F O0E' 
0 m8 0 0 OhS 01 ?• 

nuc:^ ft or. 4 014' 



H 



".TP 
FS6-4 



i'itH*> 



LQRD TMD FILES PGlOtP&gD 

LORD FILE Pi." 30 

NAME RES OBJECT FJLE 

STRPT PRS S 1 1 
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FIGURE C-4 

EXAMPLE OF LOADER WITHOUT INTERNED 1 ATE FILE 
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EXAMPLE OF LOADER WITH INTERMEDIATE Fill 



C-9 
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EXWLE OF LIBRARY FILES 
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